Nomination Routines
| |
Nomination Routine |
Description of device |
| B |
gBmp() |
Windows Bitmap Format |
| C |
gSunras() |
SUN Microsystems Raster File |
| D |
gXwd2(dpi) |
X Windows Dump |
| E |
gBmp2(dpi) |
Windows Bitmap Format |
| F |
gSunras2(dpi) |
SUN Microsystems Raster File |
Device Characteristics
| Maximum Width (mm) |
23119.29mm |
resolution dependent |
| Maximum Height (mm) |
11559.47mm |
resolution dependent |
| Default Width (mm) |
338mm |
resolution dependent |
| Default Height (mm) |
254mm |
resolution dependent |
| Resolution |
65536 x 32768 (960x720 default) |
| Colour Palette |
Dynamic (default) or Direct |
| Character Sizes |
4 Pseudo-hardware in multiples of 1.5mm square |
| Image Handling |
Full Colour and Output only |
X Windows Dump
These are image dumps used on Unix systems supporting X windows. Normally the files are created using the Unix command xwd and read in using the corresponding command xwud ( X Windows UnDump ). Files created by this driver can be created using the nomination routine gXwd() or gXwd2(). The resulting file can be read into a third party application or displayed using the following Unix command;
xwud -in xwd.out
where xwd.out is the image file created by the driver.
Windows Bitmap
These are image files used on PCs under Windows and OS/2. Files created by this driver using the nomination routine gBmp() or gBmp2(). The resulting file can be read into many third party applications using a simple image import filter.
Note: To create a BMP file from an OpenGL 3D picture, the nomination routine gWoglpp() must be used.
SUN Raster File
These are similar to screen dumps from SUN workstations. Files created by this driver using the nomination routine gSunras() or gSunras2(). The resulting file can be read by the SUN application imagetool and a limited number of third party applications.
Nomination Routines
Two nominations routines are provided for each of the three metafile formats. The first has no argument and uses a default resolution of 72 dpi for the interpretation of pixels to drawing units. The second uses a single argument where this mapping may be altered by specifying the required dots-per-inch setting.
Drawing Limits
The default drawing limits of the metafile is 960 by 720 pixels, which relates to a drawing area of 338mm by 254 mm (at 72dpi). The routine gSetDrawingLimits() can be used to change this default, but note that this routine only accepts drawing units as its settings, not pixels.
Where the user wishes to specify the size of the metafile in pixels, then this can be done in one of two ways; either by a simple calculation of the required drawing units, or by changing the drawing units to pixels. Thus, to change the drawing limits to 800 by 600 pixels, the following code can be used:
[C/C++]
GDIM paper;
paper.xpap = 800.0 * 25.4 / dpi;
paper.ypap = 600.0 * 25.4 / dpi
gSetDrawingLimits(&paper,0);
[F90]
type (GDIM) :: paper
paper%xpap = 800.0 * 25.4 / dpi
paper%ypap = 600.0 * 25.4 / dpi
call gSetDrawingLimits(paper,0)
Alternatively, the routine gDefinePictureUnits() may be used to change the drawing units to pixels. Thus:
[C/C++]
GDIM paper;
gDefinePictureUnits(25.4 / dpi);
paper.xpap = 800.0;
paper.ypap = 600.0
gSetDrawingLimits(&paper,0);
[F90]
type (GDIM) :: paper
call gDefinePictureUnits(25.4 / dpi)
paper%xpap = 800.0
paper%ypap = 600.0
call gSetDrawingLimits(paper,0)
Image Size
The resulting image size can be enquired using the GINO routine gEnqDrawingLimits() with these values being returned in current drawing units. The pixel resolution of the image can be enquired by calling gEnqPixelResolution().
Multiple Frames
The driver does not recognise multiple images within the application so only the first image will be stored. (i.e. up to the first call to gNewDrawing() after any drawing routines).
Intermediate Vector File
This driver uses an internal GINO vector to raster pre-processor to create the output for the device which contains a fixed sized memory area into which the image is rasterized.
